File naming for MSL OPGS EDRs and single frame RDRs
EDRs and single frame image RDRs generated by OPGS share the common file naming convention described on this page.
mission specific
Filenames take the pattern consisting of fixed-size fields:
| Field | inst | config | spec | sclk | prodid | geom | samp | site | drive | seqid | who | ver | . | ext |
| Position | 1-2 | 3 | 4 | 5-13 | 14-16 | 17 | 18 | 19-21 | 22-25 | 26-34 | 35 | 36 | 37 | 38-40 |
Details of the file name fields are given below.
inst - Instrument
Positions 1-2, 2 alpha characters representing instrument ID, denoting the source MSL science or engineering instrument that acquired the data.
| inst | Meaning |
|---|---|
| AP | APXS |
| CC | ChemCam generic |
| CL | ChemCam LIBS |
| CM | CheMin |
| CR | ChemCam RMI |
| DN | DAN |
| FA | Front Hazcam Anaglyph (3-banded) |
| FL | Front Hazcam Left |
| FR | Front Hazcam Right |
| FS | Front Hazcam Stereo (2-banded) |
| HA | MAHLI Anaglyph (3-banded) |
| HG | MAHLI Colorglyph (Lr, Rg, Rb) |
| HS | MAHLI Stereo (2-banded) |
| MA | Mastcam Anaglyph (3-banded) |
| MD | MARDI |
| MG | Mastcam Colorglyph (Lr, Rg, Rb) |
| MH | MAHLI |
| ML | Mastcam Left |
| MR | Mastcam Right |
| MS | Mastcam Stereo (2-banded) |
| NA | Navcam Anaglyph (3-banded) |
| NL | Navcam Left |
| NR | Navcam Right |
| NS | Navcam Stereo (2-banded) |
| RA | Front Hazcam Anaglyph (3-banded) |
| RD | RAD |
| RL | Rear Hazcam Left |
| RM | REMS |
| RR | Rear Hazcam Right |
| RS | Rear Hazcam Stereo (2-banded) |
| SM | SAM |
| SP | SA/SPaH |
config - Instrument configuration
Position 3 - 1 alphanumeric character representing the instrument configuration, an operational attribute of the Instrument that assists in characterizing the data.
| Instrument | config | Meaning |
|---|---|---|
| Front Hazcam, Rear Hazcam, Navcam | A, B | A-side configuration, B-side configuration |
| ChemCam LIBS | 0 | Image data (Fullframe, Subframe, Downsampled, Thumbnail, Reference Pixel, Row-summed, Column-summed, Histogram) |
| ChemCam RMI | 0-9 | 0 = 1-D Average Spectra, no laser; 1 = 1-D Single Spectra, no laser; 2 = Spectra Stats (Mean & Std Dev), no laser; 3 = 2-D Diagnostic, no laser; 4 = 1-D Average Spectra Laser; 5 = 1-D Single Spectra Laser; 6 = Spectra Stats (Mean & Std Dev), laser capable; 7 = 2-D Diagnostic Laser; 8 = Spectra Stats (all), laser capable; 9 = Spectra Stats (all), no laser |
| ChemCam Generic | 0-5 | 0 = SOH; 1 = Params; 2 = Memory Dump; 3 = Debug Dump; 4 = Move Focus; 5 = Util Test |
| Mastcam | 0-7 | Filters 0 thru 7 |
| R, G, B, F, U, L, D, C, A | r = Red Bayer cells only, or Red band of JPEG’d product; G = Green Bayer cells only, or Green band of JPEG’d product; B = Blue Bayer cells only, or Blue band of JPEG’d product; F = Full color de-Bayered RGB merged into single 3-band image; U = Upper half of Green cells only; L = Lower half of Green cells only; D = All Green cells (double resolution in one dimension); C = All cells, corrected for responsivity with the filter; A = All cells, with 2x2 averaging | |
| MAHLI | 0 - 3 | 0 = cover closed, LEDs off; 1 = cover open, LEDs off; 2 = cover closed, LEDs on; 3 = cover open, LEDs on |
| R, G, B, F, U, L, D, C, A | Same as for Mastcam | |
| MARDI | 0 | No filters |
| R, G, B, F, U, L, D, C, A | Same as for Mastcam |
spec - Special processing flag
Position 4, 1 character as the special processing flag, applicable to RDRs only. The Special Processing character is used to indicate off-nominal or special processing of the image. Examples include a) use of different correlation parameters, b) special stretches to eliminate shadows, c) reprocessing with different camera pointing, etc.
The meaning of any individual character in this field will be defined on an ad hoc basis as needed during the mission. Within one Sol or a range of Sol’s, the character will be used consistently. So, this field can be used to group together all derived products resulting in one kind of special processing. An attempt will be made to maintain consistency across different Sol's as well, but this may not always be possible; thus the meaning of characters may change across different individual or ranges of Sol's, depending on the definition.
A ".txt" ASCII text file will be maintained containing all special processing designators that are used, the Sol's they relate to, and a description of the special processing that was done. This file will be included in the PDS archive.
Best Tactical - If value is character "T", it indicates "best tactical" if other than nominal processing. The intent of this is to hold a copy of the special product best suited for tactical planning (at the discretion of OPGS ops personnel in consultation with tactical planners). Such products should have an ordinary special processing flag documented as described here, but be copied to flag "T" (incrementing version if necessary) if they are to be used for tactical planning.
If there is no "T", then the nominal "_" should be used for tactical planning.
| spec (EDRs) | spec (RDRs) | Meaning |
|---|---|---|
| _ | _ | None |
| n/a | A - S |
Special method types A-S and U-Z |
| n/a | U - Z | Best tactical Special method |
sclk - Spacecraft clock count
Positions 5-13, 9 alphanumeric characters representing the spacecraft clock count in seconds. Which specific SCLK is used depends on the instrument but is generally expected to be the time the data was acquired. For the engineering cameras and ChemCam, the SCLK in the IDPH is used. For MMM cameras, the SCLK in the MMM mini-header is used. It is not guaranteed that this SCLK match the DVT (Data Validity Time) used for operational data management.
prodid - Product ID
Positions 14-16, 3 characters as a product type identifier. Values beginning with "E" are of type EDR, which is the first order product with no processing applied, such as geometric correction ("linearization") or radiometric correction. Otherwise, the product is an RDR.
| Image EDRs | |
| prodid | Meaning |
|---|---|
| EDR | First order product |
| ERP | Reference Pixel |
| ERS | Row-summed |
| ECS | Column-summed |
| EHG | Histogram |
| EIN | State-of-Health Initialize (ChemCam SOH only) |
| EPW | State-of-Health Power On (ChemCam SOH only) |
| EPO | State-of-Health Power Off (ChemCam SOH only) |
| EWU | State-of-Health Warmup (ChemCam SOH only) |
| ESS | State-of-Health Sun Safe (ChemCam SOH only) |
| EJP | Original JPEG as received from rover (MMM cameras only) |
| EZS | Z-stack combined image (MMM cameras only) |
| EDM | Depth map image (MMM cameras only) |
| EVD | Video image (MMM cameras only) |
| ERD | Recovered EDR (MMM cameras only) |
| Image RDRs | |
| prodid | Meaning |
|---|---|
| LIN | CAHV-linearized (identical to "EDR" except for Geometry type) |
| BAY | Bayer pattern (identical to "EDR" except for Bayer pattern extract) |
| ILT | Inverse lookup table (ILUT) |
| ILC | Inverse lookup table (ILUT) with corrections such as despike |
| ILP | Inverse lookup table (ILUT) with pointing correction applied |
| RAD | Rad-corrected absolute radiance units, integer |
| RAS | Rad-corrected absolute radiance units, scaled to 12-bit |
| RAF | Rad-corrected absolute radiance units, float |
| RIE | Rad-corrected for Instrument Effects only, integer DN |
| RIF | Rad-corrected for Instrument Effects only, float |
| IOI | Rad-corrected IOF radiance factor, integer |
| IOF | Rad-corrected IOF radiance factor, float |
| DSP | Stereo Disparity Final |
| DSR | Stereo Disparity Raw |
| DSL | Stereo Disparity of Lines (single-band) |
| DSS | Stereo Disparity of Samples (single-band) |
| DSG | Stereo Disparity Grid |
| DSE | Stereo Disparity Error Metric |
| MDS | Stereo Disparity Mask File |
| DDD | Stereo Delta Disparity (2-band, true disparity offset) |
| DDL | Stereo Delta Disparity Line (single-band) |
| DDS | Stereo Delta Disparity Sample (single-band) |
| DFF | Stereo First-stage Disparity Final |
| DFL | Stereo First-stage Disparity Line |
| DFS | Stereo First-stage Disparity Sample |
| XYZ | XYZ expressed in Site frame |
| XYE | XYZ Error Metric |
| XYR | XYZ expressed in Rover Nav frame |
| XYM | XYZ Masked |
| MXY | XYZ Mask File |
| XYO | XYZ with Overlay |
| XYF | XYZ Filled |
| XXX | XYZ X-band |
| YYY | XYZ Y-band |
| ZZZ | XYZ Z-band |
| XXF | XYZ X-band Filled |
| YYF | XYZ Y-band Filled |
| ZZF | XYZ Z-band Filled |
| UVW | Surface Normal (UVW) |
| UVS | Surface Normal (UVW) for Slope computations |
| UVP | Surface Normal (UVW) Projected onto Plane |
| UVT | Surface Normal (UVW) Angle (‘T’ for theta) between Normal and Plane |
| UVO | Surface Normal (UVW) with Overlay |
| UVF | Surface Normal (UVW) Filled |
| UUU | Surface Normal (UVW) U-band |
| VVV | Surface Normal (UVW) V-band |
| WWW | Surface Normal (UVW) W-band |
| UUF | Surface Normal (UVW) U-band Filled |
| VVF | Surface Normal (UVW) V-band Filled |
| WWF | Surface Normal (UVW) W-band Filled |
| RUD | Surface Roughness (Drill) |
| RUT | Surface Roughness (DRT) |
| RNG | Range from Camera |
| RNR | Range from Rover Nav frame origin |
| RNO | Range with Overlay |
| RNF | Range Filled |
| RNE | Range Error Metric |
| ARM | Arm Reachability |
| ARO | Arm Reachability with Overlay |
| ARK | Arm Reachability Masked |
| MAR | Arm Reachability Mask File |
| ARP | Arm Preload Values |
| SLP | Slope |
| SLO | Slope with Overlay |
| SRD | Slope Rover Direction |
| SRO | Slope Rover Direction with Overlay |
| SHD | Slope Heading |
| SHO | Slope Heading with Overlay |
| SMG | Slope Magnitude |
| SMO | Slope Magnitude with Overlay |
| SNT | Slope Northerly Tilt |
| SNO | Slope Northerly Tilt with Overlay |
| SEN | Solar Energy |
| SEO | Solar Energy with Overlay |
| IEP | Incidence, Emission, Phase angles |
| IEF | Incidence, Emission, Phase angles Filled |
| Spectroscopy (LIBS) RDRs | |
| prodid | Meaning |
|---|---|
| RDR | Initial LIBS Spectrum |
| NSR | Nearby Sample of Reference |
| MEC | Multivariate Prediction of Elemental Composition |
| MOC | Multivariate Prediction of Oxide Composition |
| UEC | Univariate Prediction of Elemental Composition |
| UOC | Univariate Prediction of Oxide Composition |
| RSM | Sammon’s Map |
| CCS | Intermediate Clean Calibrated Spectra |
geom - Geometry
Position 17, 1 alphanumeric character representing geometry type, used to differentiate products as having camera-induced distortion removed ("linearized") or not removed ("non-linearized").
note
OPGS-produced MMM products are produced to support operations and are not archived. Discussion of MMM product geometry is included to maintain consistency with the SIS.
For MMM camera products, also serves a secondary function by flagging changes in compression mode across iterations of the same data to distinguish between MMM product types.
Products from stereo cameras are normally linearized using the nominal stereo partner (whether the partner image was actually acquired or not). Products such as long-baseline or re-pointed stereo pairs, however, are often linearized using the actual stereo partner, resulting in different geometry.
This field is assigned as follows:
a) Linearization - If value is any alpha character "A - Z", then product is "linearized" using one of the two modes (nominal or actual) according to the table below. If value is not any alpha character, then product is "non-linearized".
b) First Compression Mode - For all cameras, if value is an underscore ("_"), "L" (for "linearized-nominal") or "A" (for "linearized-actual"), it denotes that compression mode is for the first instance of the product data processed on the ground. The identity of the mode type, whether "uncompressed" or a type of compression, is not provided here.
c) Changed Compression Modes - For MMM cameras, if value is an integer "1 - 9, 0" (iterating numerically in order of 1, 2 … 9, 0), or in the character ranges "M - V" (iterating alphabetically after "L" for "linearized-nominal") or "B - K" (iterating alphabetically after "A" for "linearized-actual"), it indicates a different compression mode than all previous modes noted. Again, the identity of the mode type, whether "uncompressed" or a type of compression, is not provided here.
These flags are necessary because operation of MMM cameras includes the possibility that the same image be requested multiple times from the rover, each with different compression modes. In these cases, the compression mode for the first product processed on the ground is noted. Thereafter, if the compression mode for any subsequent product processed on the ground is different than all previous modes, it will be noted and indexed incrementally (using alpha characters for "linearized" and integers for "non-linearized").
| Camera type | Compression mode | Non-linearized | Linearized | |
|---|---|---|---|---|
| Nominal | Actual | |||
| All | 1st compression mode received | _ | L | A |
| MMM only | 2nd compression mode, different than any previous mode | 1 | M | B |
| 3rd compression mode, different than any previous mode | 2 | N | C | |
| : | : | : | : | |
| 10th compression mode, different than any previous mode | 9 | U | J | |
| 11th compression mode or higher, different than any previous mode | 0 | V | K | |
NOTE
Retransmissions or reprocessing of the same compression mode will reuse the appropriate mode character, with file name’s Version field incrementing for each retransmission.
The EDR controls the compression mode flag. All RDRs derived from a given EDR share the same row in the table above. So, "2" and "N" and "C" will always correspond, for example.
samp - Sample type
Position 18, 1 character representing sample type, indicating how the data were sampled.
| samp | Meaning |
|---|---|
| B | Bayer extraction subsampling (MMM only) raster data |
| D | Downsampled raster data, reduced resolution |
| F | Full frame raster data, full resolution |
| M | Mixed (Subframe and Downsampled) raster data, mixed resolution |
| N | Non-raster data |
| S | Subframed raster data, full resolution |
| T | Thumbnail raster data, reduced resolution |
| Y | Thumbnail Bayer extraction |
site - Site location count
Positions 19-21, 3 alphanumeric characters representing the site location count within the current site, from the Rover Motion Counter.
| site | Meaning |
|---|---|
| 000, 001, ... 999 | 0 - 999 |
| A00, A01, ... A99 | 1000 - 1099 |
| Z00, Z01, ... Z99 | 3500 - 3599 |
| AA0, AA1, ... AA9 | 3600 - 3609 |
| AB0, AB1, ... AB9 | 3610 - 3619 |
| ZZ0, ZZ1, ... ZZ9 | 10350 - 10359 |
| AAA, AAB, ... AAZ | 10360 - 10385 |
| ABA, ABB, ... ABZ | 10386 - 10411 |
| 0AA, 0AB, ... 0AZ | 27936 - 27961 |
| 7DA, &DB, ... 7DV | 32746 - 32767 |
| _ _ _ (3 consecutive underscores) | Out of range |
drive - Drive location count
Positions 22-25, 4 alphanumeric characters representing the drive location count within the current site, from the Rover Motion Counter.
| drive | Meaning |
|---|---|
| 0000, 0001, ... 9999 | 0 - 9999 |
| A000, A001, ... A999 | 10000 - 10999 |
| Z000, Z001, ... Z999 | 35000 - 35999 |
| AA00, AA01, ... AA99 | 36000 - 36099 |
| AZ00, AZ01, ... AZ99 | 38500 - 38599 |
| BA00, BA01, ... BA99 | 36000 - 38699 |
| LJ00, LJ01, ... LJ35 | 65500 - 65535 |
| _ _ _ _ (4 underscores) | Out of range |
seqid - Sequence ID
Positions 26-34, 9 alphanumeric characters as a sequence identifier. Composed of a 4-char subfield and a 5-digit numeric subfield representing the 6-bit "Category" and 14-bit numeric components of the commanded Sequence ID, respectively.
who - Producer
Position 35, 1 alpha character representing the data producer.
| who | Meaning | |
|---|---|---|
| M | MIPL (Multi-mission Image Processing Laboratory), JPL | |
| P | Instrument principal investigator | |
| APXS | Max Planck Institute (Germany) | |
| ChemCam LIBS and SOH | LANL (Los Alamos, NM) | |
| ChemCam RMI | IRAP (France) | |
| CheMin | Ames Research Center (Mountain View, CA) | |
| DAN | Federal Space Agency (Russia) | |
| MARDI, Mastcam, MAHLI | MSSS (San Diego, CA) | |
| RAD | SwRI (Boulder, CO) | |
| REMS | Ministry of Education and Science (Spain) | |
| SAM | GSFC (Goddard, Md) | |
| A-L | Co-Investigators (to be identified by PI per instrument) | |
ver - Version
Position 36, 1 alphanumeric character as the version identifier. The Version number increments by one whenever an otherwise-identical filename would be produced. The valid values, in their progression that excludes "0" altogether, are as follows (non-Hex):
| ver | Meaning |
|---|---|
| 1, 2, ... 9 | 1-9 |
| A, B, ... Z | 10-35 |
| _ | 36 and higher |
Note
that not every version need exist, e.g. versions 1, 2 and 4 may exist but not 3. In general, the highest-numbered Version represents the "best" version of that product.
This field increments independently of all fields, including the Special Processing field.
ext - Extension
Position 38-40, 2 to 3 alphanumeric characters denoting the product type.
Valid values for nominal operations products:
| IMG | Image EDRs / RDRs (ODL-format labeled, may include embedded VICAR) |
| VIC | Temporary image EDR / RDRs with only VICAR label (no ODL-format label) |
| iv | Per-wedge Terrain Mesh RDR in Inventor binary format (no label) |
| ht | Per-wedge Height Map RDR (VICAR label) |
| rgb | Per-wedge Terrain Mesh texture RDR in RGB format (no label) |
| LBL | Detached label in PDS or ODL format |
| JPG | JPEG compressed (no label) |
| TIF | TIFF format (no label) |
| PNG | PNG format (no label) |
| TXT | Text file associated with Specially-processed files |
| tar | Tar file containing Per-wedge Terrain Mesh vertice tile files |
Valid values for non-image products:
| QUB | Multi-layer spectral cube data |
| CSV | Comma-separated-value text file, used for LIBS RDRs |
| DAT | Non-imaging instrument data, including LIBS and ChemCam state-of-health |
| LBL | Detached label in PDS or ODL format |
| TAB | Table data |